home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / wb / RndBdrop.lha / Readme.txt < prev    next >
Text File  |  1997-10-18  |  3KB  |  70 lines
  1. Random Backdrop (RandBackdrop) Program
  2.  
  3. Function:    The program makes a random selection from a number of .iff files for 
  4. the WB backdrop picture selected by Preferences.
  5.  
  6. Purpose:    I like pretty pictures, but I get sick of changing them with Preferences. 
  7. This program makes Preferences show a different picture after each reboot.
  8.  
  9. How it works:    The program copies the selected file into T: under the (fixed) 
  10. filename "Backdrop.iff". Preferences is set to look in T: for that filename.
  11.  
  12. Requirements:    WB 3.x only.
  13.     Program size: 14 kb
  14.     File size:    20 kb
  15.     To be automatic, program must be run within startup sequence before WB is 
  16. loaded.
  17.  
  18. Machine used for creation and debugging:    A4000 + Cyberstorm 060/50 + WB 
  19. 3.1 + 144 MB.
  20.  
  21. How to run:    (CLI only)
  22.     Type "RandBackdrop <directory> <number of files>", where
  23.     RandBackdrop is the name of the program (case is unimportant);
  24.     <directory> is the directory containing your backdrop files;
  25.     <number of files> is the number of files in your directory.
  26.  
  27. What you have to do:    
  28.     1.    Add RandBackdrop to C: or some other suitable place that can be 
  29. reached during the startup sequence.
  30.     2.    Make up a directory of your favourite backdrop pictures (.iff). They must 
  31. have names such as "PIXyyy.iff", where yyy is a number from 001 to 999, with 
  32. leading zeroes.
  33.     3.    Add the command "RandBackdrop <directory> <number files>" to 
  34. either s:Startup-Sequence or s:User-Startup. The new command must be after the 
  35. RAM: directory T: is created, and before the LoadWB command.
  36.     4.    Go into Preferences and set WBPattern to "Picture". Choose the picture 
  37. "T:Backdrop.iff" (There won't be one there until you have run RandBackdrop).
  38.  
  39. Notes:    The program uses the Rand() function to generate a random filename 
  40. between pix001.iff and pixyyy.iff inclusive, where yyy is the "number of files" 
  41. specified on the command line. It looks up the filename to check it exists, and then 
  42. uses the Execute library function which calls Copy to copy the file. The original file 
  43. is untouched. I like to leave my files write-protected when I can.
  44.  
  45. Built-in checks:
  46. 1.    Filename is checked for existence before calling Copy (Copy crashes if it isn't 
  47. there).
  48.  
  49. Bugs:
  50. 1.    If the destination file is already in T:, this program can't delete it (it's 
  51. probably been opened by Preferences and can't be deleted). Make sure that 
  52. "T:Backdrop.iff" does not exist when RandBackdrop is called.
  53. 2.    RandBackdrop performs no checking on the file - it merely copies it to T: If 
  54. the contents are garbage, Preferences might crash.
  55.  
  56. Modifying:
  57.     I have included the source, since it's so simple and represents only a couple 
  58. of hours' work. I used SAS/C version 6.55 to compile it. I haven't included any 
  59. pictures, since all mine have been scanned from calendars and are copyrighted.
  60.  
  61. Payment:    None. Feel free to use this program as you see fit. An E-mail to 
  62. awyatt@matra.com.au would be appreciated.
  63.  
  64. Disclaimer:    You load or use this program at your own risk. If it crashes and destroys 
  65. all your investment data, don't call me.
  66.  
  67. Tony Wyatt
  68.  
  69. 18th October 1997
  70.